."   Copyright (c) 2007 DUDOUET Clément.
."  Permission is granted to copy, distribute and/or modify this document
."  under the terms of the GNU Free Documentation License, Version 1.2
."  or any later version published by the Free Software Foundation;
."  with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
."  Texts.  A copy of the license is included in the project in directory
."  [$PROJECT_PATH]/doc/fdl.txt
.TH filoo_write 2 "Fevrier 11, 2007" "version 1.0" "Manuel d'utilisateur"
.SH NOM
filoo_write \- Ecriture dans un fichier circulaire préalablement ouvert
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.sp
.BI "ssize_t filoo_write(int " fd ", const void *" buffer ", size_t " count ");
.SH DESCRIPTION
.B filoo_write
écrit
.I count
bytes dans le fichier référencé par le descripteur de fichier
.I fd
depuis le tampon commençant en
.IR buffer "."
.sp
Le descripteur de fichier
.I fd
doit correspondre a un fichier circulaire préalablement ouvert grâce aux appels sytème
.BR filoo_open "(2) ou " filoo_create "(2)"
.sp
Cet appel système agit comme l'appel
.BR write "(2)"
a la différence près que l'écriture du (size + n) ème octet, écrase l'octet n.
.SH VALEUR RENVOYEE
.B filoo_write
renvoie le nombre d'octets écrits (0 signifiant aucune écriture), ou \-1 s'il échoue, auquel cas
.I errno
contient le code d'erreur correspondant.
.SH ERREURS
.TP
.B EBADSEEK
Si le pointeur d'écriture a été placé dans la zone d'entête du fichier, l'écriture est interdite.
.TP
.B EBADFD
.I fd
n'est pas un descripteur de fichier valide, ou n'est pas ouvert en écriture.
.TP
.B ...
cf.
.BR write "(2)"
.SH VOIR AUSSI
.BR filoo_close "(2),"
.BR filoo_create "(2),"
.BR filoo_open "(2),"
.BR filoo_read "(2)"
.SH AUTEUR
Clément DUDOUET
.SH DISPONIBILITE
Le projet est disponible a cette adresse :
.TP
.B http://code.google.com/p/filoo
.TP
Et par l'intermédiaire de SVN en utilisant la commande :
.TP
.B svn checkout http://filoo.googlecode.com/svn/trunk/ filoo
